Disposes of the private data structures allocated by the NewPictInfo function.

OSErr DisposePictInfo (
    PictInfoID thePictInfoID
);

Parameter descriptions

thePictInfoID

The unique identifier returned by NewPictInfo.

function result

A result code.

DISCUSSION

The DisposePictInfo function does not dispose of any of the handles returned to you in a PictInfo structure by the RetrievePictInfo function. Instead, you can dispose of a Palette structure by using the DisposePalette function. You can dispose of a ColorTable structure by using the DisposeCTable function. Dispose of other allocations with the DisposeHandle function.

Use this function when you are finished gathering information from a survey of pictures, pixel maps, or bitmaps.

SPECIAL CONSIDERATIONS

The DisposePictInfo function may move or purge memory.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)